Release 10.1A: OpenEdge Development:
Progress 4GL Reference

Control-Name property

The component handle to an ActiveX control that has the specified design-time name (Control-Name) and that is loaded into the control-frame.

Data type: COM-HANDLE

Access: Readable

Applies to: CONTROL-FRAME widget, COM object

To return the component handle of the ActiveX control, you provide the design-time name as a property of the control-frame COM object:

DEFINE VARIABLE hSpin AS COM-HANDLE. DEFINE VARIABLE hControlFrameCOM AS COM-HANDLE. DEFINE VARIABLE hControlFrame AS WIDGET-HANDLE. /* ... Instantiate the control-frame with hControlFrame and load the Spin control into it ... */ hControlFrameCOM = hControlFrame:COM-HANDLE. hSpin = hControlFrameCOM:Spin.

In this example, Spin is the name of an ActiveX control and is also used as a property to return the handle to that control.

This is the simplest technique to access an ActiveX control that is loaded in a control frame.

Notes

Another way of getting a component handle to an ActiveX control is to access it through the control collection. For more information, see the Controls property entry.
References to COM object properties and methods extend the syntax used for referencing widget attributes and methods. For more information, see the "Referencing COM object properties and methods" section.